<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3c.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang=zh-CN 
xmlns="http://www.w3.org/1999/xhtml">

<head>
  <link rel="shortcut icon" href="images/X3DtextIcon16.png" title="X3D" > 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<title>X3D-Edit for Extensible 3D (X3D) Graphics - README-X3D开发者-WEB3D中文基地</title>
	<meta name="author" content="Don Brutzman">
	<meta name="description" content="README X3D-Edit">
	<meta name="filename" content="README.X3D-Edit.html">
	<meta name="url" content="http://www.web3d.org/x3d/content/README.X3D-Edit.html">
	<meta name="generator" content="HTML-Kit">
<link rel="stylesheet" href="../../images/style.css" type="text/css">
</head>

<body>
<DIV id="mainWrapper">

<div id="leftp">
	<ul id="nav">
	<li><a href="../../">首&nbsp;&nbsp;&nbsp;&nbsp;页</a></li>	
					
	<li><a href="../../about/">关于Web3D</a>
	<ul>
	<li><a href="../../about/overview/">X3D是什么</a></li>
	<li><a href="../../about/faq/">X3D FAQ</a></li>
	<li><a href="../../about/mission/">宗旨</a></li>
	<li><a href="../../about/ip/">章程、协议&amp;知识产权政策</a></li>
	<li><a href="../../about/board/">理事会</a></li>
	<li><a href="../../about/liaisons/">联络点与合作伙伴</a></li>
	<li><a href="../../sitemap/">站点地图</a></li>

	</ul>
	</li>	

	<li><a href="../../x3d/">X3D开发</a>
		<ul>
		<li><a href="../../x3d/content/examples/X3dResources.html#Applications">浏览器软件</a></li>
		<li><a href="../../x3d/content/examples/X3dResources.html#AuthoringSoftware">创作软件</a></li>     
		<li><a href="../../x3d/content/examples/X3dResources.html#Conversions">转换工具</a></li>
		<li><a href="../../x3d/content/examples/X3dResources.html#Examples">实例与脚本</a></li>
		<li><a href="../../x3d/content/examples/X3dResources.html#Training">培训</a></li>
		<li><a href="../../x3d/specifications/">X3D规范</a></li>
		<li><a href="../../x3d/learn/tutorial/">手册</a></li>
		<li><a href="../../tools/developer_tools/">开发工具包</a></li>
		<li><a href="../../tools/">总体介绍</a></li>
		<li><a href="../../x3d/workgroups/">工作组</a></li>
		<li><a href="../../x3d/conformance/">一致性测试</a></li>
		<li><a href="../../x3d/opensource/">开源项目</a></li>
		<li><a href="http://www.web3d.org/message_boards/">开发者论坛</a></li>
		<li><a href="http://www.web3d.org/x3d/wiki/">X3D维基</a></li>
		<li><a href="../../library/C9">书籍</a></li>
		<li><a href="../../library/C10">产品</a></li>
		</ul>
	</li>	

	<li><a href="../../community/">社&nbsp;&nbsp;&nbsp;&nbsp;区</a>
	<ul>
	<li><a href="../../casestudies/">案例研究</a></li>
	<li><a href="../../x3d/publiclists/">公共邮件列表</a></li>
	</ul>
	</li>

	</ul>

</div>
 <DIV class="content">

<table border="0" cellspacing="0" cellpadding="0" summary="">
<tr align="center">
		<td><a href="http://www.web3d.org/x3d"><img src="images/x3d2-s.gif" width="154" height="97" border="0" title="to X3D home page"></a></td>
		<td><pre>   </pre></td>
		<td>
				<h1>X3D-Edit for Extensible&nbsp;3D (X3D) Graphics - README</h1>
		</td>
		<td><pre>   </pre></td>
		<td><a href="http://www.web3d.org"><img src="images/web3d_logo2.png" width="120" height="60" border="0" title="to Web3D home page"></a></td>
</tr>
</table>
<p>    
<a href="http://web.nps.navy.mil/~brutzman">Don&nbsp;Brutzman</a>
(<i><a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20feedback ">brutzman&nbsp;at&nbsp;nps.navy.mil</a></i>)
<br />
翻译：web3d中文基地
<br />
2007年冬的时候，发布了基于Netbeans的完全重构的X3D-Edit 3.2版，可以到<a href="https://savage.nps.edu/X3D-Edit/" target="_blank">https://savage.nps.edu/X3D-Edit/</a>处了解更多信息。
</p>

<p><font size="-1">

<a href="http://www.web3d.org/x3d/content/X3D-EditAutoInstall/Web_Installers/install.htm">自动安装</a>  |
<a href="#Purpose">目标</a> |
<a href="#Status">状态</a> |
<a href="#i18n">国际化 (i18n)</a> |
<a href="#Installation">安装设置</a> |
<a href="#Updates">下载更新</a> |
<a href="#Features">特性</a> |
<a href="#Details">细节</a> |
<a href="#Usage">用法</a> |
<a href="#Compact">简化形式</a> |
<a href="#Developers">开发者</a> |
<a href="#Bugfixes">Bug修复</a>

</font></p>
</center>
<hr width="50%">

<h3><a name="Purpose">目标</a></h3>
<p>
	 X3D-Edit是一款图形化<a href="../../x3d" target="_blank">可扩展 3D (X3D)</a>文件编辑器，让你可以很简单地进行无错式编辑、创作与有效性验证X3D/VRML场景图文件。上下文敏感工具提示对每个X3D节点与属性提供简要的概况。让你可以很简单地进行无错式编辑、创作与验证X3D/VRML场景图文件。上下文敏感工具提示对每个X3D节点与属性提供简要的概述。这些提示简化了创作。并对新手和专家级用户同样具有提高理解的作用。
</p>
<p>
    <a href="http://www.web3d.org/x3d/content/X3D-EditAutoInstall/Web_Installers/install.htm" target="_blank">X3D-Edit自动安装器</a> 可在线进行，各种操作系统（Windows, Mac, Linux, Solaris及其它 Unix）下都有。
</p>

<p>	 
	 X3D-Edit采用<a href="x3d-3.1.dtd" target="_blank">《X3D 3.1 文档类型定义（DTD）》</a>中定义的X3D 3.1标签集，组合了Sun的<a href="http://www.javasoft.com/nav/download" target="_blank">Java</a>，IBM的<a href="http://www.alphaWorks.ibm.com/tech/xeena" target="Xeena">Xeena XML editor</a>及编辑器Profile配置文件。 
</p>

<p>查看<a href="examples/help.html" target="_blank">X3D帮助</a>以获取更多的X3D资源。
</p>

<hr width="50%">

<h3><a name="Status">状态</a></h3>
<p>
    X3D-Edit实现可扩展3D（X3D）-下一代虚拟现实建模语言（VRML 200X）-标签集。X3D-Edit也试着进行各种X3D图形渲染及转换的实现。
</p>
<p>
		软件与实例最近的<a href="#Updates">更新</a>：查看 <a href="build.date.X3D-Edit.txt"><b>build.date.X3D-Edit.txt</b></a>.
</p>
	 
<p>		<b><font color="red">现在的3.1版本</font></b>，匹配<a href="http://www.web3d.org/x3d/specifications" target="_blank">X3D&nbsp;3.0 国际规范</a>
				(2004 夏) ，并加入了<a href="http://www.web3d.org/x3d/specifications/ISO-IEC-19775-Amendment1-X3DAbstractSpecification" target="_blank">X3D 修正案 第一版</a>中的一些组件 (2005 冬)。（注：2007年冬的时候，发布了基于Netbeans的完全重构的X3D-Edit 3.2版，可以到<a href="https://savage.nps.edu/X3D-Edit/" target="_blank">https://savage.nps.edu/X3D-Edit/</a>处了解更多信息。）
</p>
<p>
	 完成了的v3.1组件：
<ul>
		<li>更新的x3d-3.1.dtd</li>
		<li>CAD组件</li>
		<li>可编程Shader组件</li>
		<li>立方体式映射环境纹理组件</li>
		<li>LocalFog 与 FogCoordinate</li>
		<li>Texture3D组件</li>
		<li>其它杂项的更新</li>
</ul>
</p>

<p>
	 还在进行的有：测试<a href="x3d-3.1.xsd" target="_blank">X3D&nbsp;Schema&nbsp;(x3d-3.1.xsd)</a>，通过<a href="http://www.web3d.org/x3d/content/examples/help.html#Examples" target="_blank">几千个X3D实例</a>，做成了<a href="http://www.altova.com" target="_blank">XML&nbsp;Spy</a>的一个<a href="X3D-XmlSpyProject.spp" target="_blank">项目文件</a>。
	 
</p>
	
<p><font color="green"><b>功能改善</b></font>：</p>

<ul>
  <li>  <a href="http://www.web3d.org/x3d/specifications" target="_blank">Web3D&nbsp;规范</a>
				X3D、仿人体动画（H-Anim）及虚拟现实建模语言（VRML 97）都包含进来了。
	</li>
  <li>  <a href="X3D-EditAuthoringTool.pdf" target="_blank">X3D-Edit&nbsp;创作工具（用于可扩展3D(X3D)图形）</a> 提供了一份长达6页关于X3D-Edit特性与用法的概述。也可在线查看：<a href="http://www.web3d.org/x3d/content/X3D-EditAuthoringTool.ppt" target="_blank">Powerpoint&nbsp;幻灯片s</a>
				及
				<a href="http://www.web3d.org/x3d/content/X3D-EditAuthoringTool.html" target="_blank">html&nbsp;幻灯片</a>。
				<a href="http://www.agc.fhg.de/campfire" target="_blank"><i>ACM&nbsp;SIGGRAPH/Eurographics Campfire关于3D计算机图形应用程序开发过程</i></a>,
				Snowbird&nbsp;Utah, June&nbsp;2-4&nbsp;2002.
	</li>
  <li>  <b><font color="red"><a name="VRML97Import">VRML 导入</a> 具有VRML转换成X3D的能力</font></b>，使用<a href="http://ovrt.nist.gov/v2_x3d.html">NIST Vrml97ToX3d转换器</a>。
				<ul>
						<li >
								选择“文件”-“导入”，出现一个文件对话框：
						</li>
						<li>
								<img src="../../images/Vrml97ImportFileMenu.png" title="Vrml97 Import File Menu">
						</li>
						<li>
								从对话框中选中一个VRML文件（SomeScene.wrl）：
						</li>
						<li>
								<img src="../../images/Vrml97FileSelectionDialogBox.png" title="Vrml97 File Selection Dialog Box">
						</li>
						<li>
								选择是存于<b>剪贴板</b>还是<b>新建一个文档</b>：
						</li>
						<li>
								<img src="../../images/Vrml97ImportDialogBox.png" title="Vrml97 Import Dialog Box">
						</li>
						<li>
								接下来，根据你的选择，要么<b>将导入的内容从剪贴板中粘贴到当前X3D场景中某个已有的节点上</b>。或选择新建的那个文档。推荐将内容粘贴到新文档的X3D节点下，这样就可以附带合适的DTD。
						</li>
						<li>
								重要的最终步骤：<b>另存（Save As）</b>成一个新的 .x3d 场景。  
								否则你会得到一个隐晦的控制台消息（<code>java.lang.StringIndexOutOfBoundsException: String index out of range: -1</code>）。
								更进一步的编辑及VRML/HTML样式表输出现在可以工作。
						</li>
				</ul>
	</li>
  <li>  工具提示支持：
				<a href="X3dTooltipsChinese.html" target="_blank">中文</a>，
				<a href="X3dTooltips.html" target="_blank">英文</a>，
				<a href="X3dTooltipsFrench.html" target="_blank">法语</a>，
				<a href="X3dTooltipsGerman.html" target="_blank">德语</a>，
				<a href="X3dTooltipsItalian.html" target="_blank">意大利语</a>，
				<a href="X3dTooltipsPortuguese.html" target="_blank">葡萄牙语</a>
				及
				<a href="X3dTooltipsSpanish.html" target="_blank">西班牙语</a>。
				其它语言的翻译工作也正在进行，以便更进一步改进对X3D工具提示的<a href="#i18n">国际化&nbsp;(i18n)&nbsp;支持</a>
	</li>
	<li>  目前提供了三个XSLT转换按钮：Internet Explorer VRML, Netscape VRML, Internet Explorer HTML。Three XSLT translation buttons now provided:这使得在多浏览器更容易测试场景，并提供了对原本只运行在Netscape安全模式下的DIS Profile的更好的支持。</li>
  <li> 为所有的VRML&nbsp;97节点添加了访问类型(eventIn/eventOut/field/exposedField)信息。</li>
	<li>目前绑定了<a href="http://ovrt.nist.gov/v2_x3d.html">NIST Vrml97ToX3d 转换器</a>（在x3d/content目录中可以找到）。包含<a href="Vrml97ToX3d.jar">Vrml97ToX3d.jar</a>及<a href="Vrml97ToX3d.bat">Vrml97ToX3d.bat</a>。我们已经在X3D-Edit中把这个功能集成到了<i>“VRML导入”</i>菜单。
	</li>
	<li>更新对<a href="http://web.nps.navy.mil/~brutzman/vrtp/dis-java-vrml/download.html">分布式交互仿真 (DIS)</a> 
				profile<a href="http://web.nps.navy.mil/~brutzman/vrtp/dis-java-vrml/ReleaseNotes.txt">最近的改进</a>的支持。</li>
	<li>现在从X3D到VRML的样式表转换过程中，会输出属性有效性验证报告。</li>
	<li>大量的错误与提示会在状态栏中显示。	A large set of detected errors and warnings are displayed in the status window.	</li>
	<li>许多相关性检测能揭示出<code>原型</code>，<code>脚本</code>，<code>域</code>，<code>域值</code>，<code>路由</code>范围及<code>IS</code>结构的语义错误。</li>
	<li>对修订过的LatticeXvl(<code>XvlShell</code>标签)的支持。</li>
	<li>改进了HTML输出的颜色代码，使得具有更好的可读性，并能对<code>ROUTE</code>与<code>IS</code>的关系手动注释。</li>
</ul>	

<p>		<font color="green"><b><a name="i18n">国际化(i18n)</a></b></font>: </p>

<ul>
	<li>	<b>Tooltip 页面</b>现有几种语言：
				<a href="X3dTooltipsChinese.html" target="_blank">中文</a>，
				<a href="X3dTooltips.html" target="_blank">英文</a>，
				<a href="X3dTooltipsFrench.html" target="_blank">法文</a>，
				<a href="X3dTooltipsGerman.html" target="_blank">德文</a>，
				<a href="X3dTooltipsItalian.html" target="_blank">意大利文</a>，
				<a href="X3dTooltipsPortuguese.html" target="_blank">葡萄牙文</a>及<a href="X3dTooltipsSpanish.html" target="_blank">西班牙文</a>。</li>
				
	<li>对tooltip的翻译使用XML配置文件存储，意味着我们将来VRML 200x/X3D的完善内容中能够包含基于标准的国际化（i18n）支持。</li>

	<li>	<i>X3d-Edit-Chinese.bat</i> 启动X3D-Edit后使用中文tooltips。</li>
	
	<li>	<i>X3d-Edit-French.bat</i> 启动X3D-Edit后使用法文tooltips。</li>

	<li>	<i>X3d-Edit-German.bat</i> 启动X3D-Edit后使用德文tooltips。</li>

	<li>	<i>X3d-Edit-Italian.bat</i> 启动X3D-Edit后使用意大利文tooltips。</li>

	<li>	<i>X3d-Edit-Spanish.bat</i> 启动X3D-Edit后使用西班牙文tooltips。</li>
	
	<li>可根据你的需要修改你的环境变量， 
		<code>SET&nbsp;X3dLanguagePreference=Chinese</code>
		或
		<code>SET&nbsp;X3dLanguagePreference=French</code>
		或
		<code>SET&nbsp;X3dLanguagePreference=German</code>
		或
		<code>SET&nbsp;X3dLanguagePreference=Italian</code>
		或
		<code>SET&nbsp;X3dLanguagePreference=Spanish</code>.
		
		常规下X3D-Edit图标就会调用 <i>en&nbsp;Fran&#231;ais</i> 或 <i>en&nbsp;Espa&#241;ol</i> 等。	</li>
		
	<li>	<i>X3d-Edit-English.bat</i> 启动X3D-Edit后使用英文（覆盖掉任何其它参数设置）。</li>
	<li>非常感谢我们的翻译者。
	  <ul>
		<li>	
			<a href="X3dTooltipsChinese.html">中文工具提示（tooltips）</a>：
			<a href="mailto:m17design@hotmail.com(yiqi%20meng)?subject=X3D-Edit%20language%20feedback ">孟一奇（yiqi meng）</a>，
      <a href="http://m17design.myetang.com/x3d" target="blank">南京艺术学院</a>，中国 南京。</li>
		<li>	
			<a href="X3dTooltipsFrench.html">法文tooltips</a>：
			<a href="mailto:froussille@yahoo.com(Frederic%20Roussille)?subject=X3D-Edit%20language%20feedback ">Frederic Roussille</a> of 
				Ecole Nationale des Ingenieurs de Tarbes (ENIT), Tarbe France	</li>
		<li>	
			<a href="X3dTooltipsGerman.html">德文tooltips</a>:  
			<a href="mailto:dachselt@inf.tu-dresden.de(Raimund%20Dachselt)?subject=X3D%20tooltips%20translation%20feedback%20">Raimund Dachselt</a> 与
			<a href="mailto:johnnyri@web.de(Johannes%20Richter)?subject=X3D%20tooltips%20translation%20feedback%20">Johannes Richter</a> of the 
			<a href="http://www-mmt.inf.tu-dresden.de" target="blank">Multimedia Technology Group</a>, 
			<a href="http://www.tu-dresden.de" target="blank">Dresden University of Technology</a>, Germany.	</li>
		<li><a href="X3dTooltipsItalian.html">意大利文tooltips</a>:  
		 <a href="mailto:ranon@dimi.uniud.it(Roberto Ranon)?subject=X3D tooltips translation feedback ">Roberto Ranon</a> of the 
			<a href="http://www.uniud.it" target="blank">L'Universita degli Studi di Udine</a>, Italy.
       </li>
       <li>	
			<a href="X3dTooltipsSpanish.html">西班牙文tooltips</a>:
			<a href="mailto:gmunoz@escet.urjc.es(Guadalupe%20Mu駉z%20Mart韓)?subject=X3D-Edit%20language%20feedback%20">Guadalupe Muñoz Martín</a> 
			of University Rey Juan Carlos, Madrid España。	</li>
	  </ul>
	</li>
	
	<li>
		 编辑器profile配置文件：
	 <ul>
	 	<li>	<a href="x3d-3.0.profile.xml" target="_blank" type="text/plain">x3d-3.0.profile.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profileChinese.xml" target="_blank" type="text/plain">x3d-3.0.profileChinese.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profileFrench.xml" target="_blank" type="text/plain">x3d-3.0.profileFrench.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profileGerman.xml" target="_blank" type="text/plain">x3d-3.0.profileGerman.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profileItalian.xml" target="_blank" type="text/plain">x3d-3.0.profileItalian.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profilePortuguese.xml" target="_blank" type="text/plain">x3d-3.0.profilePortuguese.xml</a> </li>
	 	<li>	<a href="x3d-3.0.profileSpanish.xml" target="_blank" type="text/plain">x3d-3.0.profileSpanish.xml</a> </li>
	 </ul>
	</li>

	<li>有兴趣的话，了解：
		<a href="http://www.w3.org/International">万维网组织(W3C) 国际化&nbsp;(i18n)</a></li>
	<li>候选翻译人员：请向<a href="mailto:www-vrml@web3d.org?subject=X3D%20tooltip%20translation%20interest%20">www-vrml@web3d.org</a>提交你的计划，以便我们能避免重复的努力。有很多好的工作可以分享！</li>
  <li>翻译者（与创作者）请注意，所有的特殊字符需要转换成“字符实体”，这些都在<a href="http://www.w3.org/TR/html4">HTML 4.01 建议</a>, 
第24章 "HTML 4中字符实体参考,"
<a href="http://www.w3.org/TR/html4/sgml/entities.html">http://www.w3.org/TR/html4/sgml/entities.html</a>中作了很好的描述。 </li>
	<li>工作预告：将所有的tooltips置于CVS控制下，以更好的对其进行维护。</li>
	<li>工作预告：将tooltips与X3D Schema进行整合。</li>
	<li>欢迎对其它语种的翻译。请联系<a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20translation%20feedback ">Don&nbsp;Brutzman (<i>brutzman&nbsp;at&nbsp;nps.navy.mil</i>)</a>一获取更多关于怎样成为志愿者的细节-你将会是一个好的伙伴。</li>

</ul>

<p><font color="green"><b>"工具是怎样组织起来的" 图示</b></font>：
<a href="XmlToolRelationshipsForX3d.pdf" target="_blank">XML Tool Relationships for X3D</a>.	
</p>

<p><font color="green"><b>教学</b></font>:
    我们在使用X3D-Edit来教授一门<a href="http://web.nps.navy.mil/~brutzman/vrml" target="_blank">VRML/X3D&nbsp;课程</a>。对减少内容bug及消除VRML语法特性真的有帮助。2000年一月份到三月份对这门课程采用beta版教学的时候，讲完<a href="http://www.wiley.com/compbooks/vrml2sbk/cover/cover.htm" target="_blank">VRML 2.0资源手册</a>中材料的速度比以前的方式快了一个星期。我们采用X3D-Edit当前版本达到了近似的高效的过程。资源手册中实例（共270个）的X3D版本可在<A href="examples/Vrml2.0Sourcebook">Vrml&nbsp;2.0资源手册实例X3D版</A>站点上获得。
</p>
		
<p>
		欢迎作出对<a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20feedback%20">X3D-Edit</a>安装/不稳定相关的建议与改进。可以在<a href="mailto:www-vrml@web3d.org?subject=X3D-Edit%20feedback " target="_blank">www-vrml 邮件列表</a>中讨论该工具。
</p>
<p>
    Mac上的介绍在<a href="README.X3D-Edit.Mac.txt">README.X3D-Edit.Mac.txt</a>中。
    感谢mac爱好者<a href="mailto:guynups@gra.com(Steve%20Guynup)?subject=README.X3D-Edit.Mac.txt%20feedback%20">Steve Guynup</a> 
		(<a href="mailto:guynups@gra.com(Steve%20Guynup)?subject=README.X3D-Edit.Mac.txt%20feedback%20">guynups@gra.com</a>)
</p>


<hr width="50%">

<h3><a name="Installation">安装设置</a></h3>

<p>你需要以具有administrator权限的身份登录，以便执行其中的一些安装。
</p>
 
	
  <p>  <b><font color="green"><i>推荐安装</i>：<a name="autoinstaller">自动安装器</a></font></b>。
				<a href="http://www.web3d.org/x3d/content/X3D-EditAutoInstall/Web_Installers/install.htm" target="_blank">X3D-Edit AutoInstaller</a> 
				可以在各种操作系统下进行(Windows, Mac, Linux, Unix/Solaris).
	</p>
	<p>如果已经安装过了，且系统中有了VRML插件（按照步骤1），你可以<a href="#Updates">跳到步骤7，直接更新到新版本</a>，并简单提取上面的<a href="#Updates">更新</a>。
	</p>
	
	<p>如果你选择手动安装X3D-Edit，按照步骤1-6来，不要用自动安装器。</p>
<ol>
<li>
   给你的浏览器选择一款免费的VRML插件装上。以下这些插件可以和<a href="http://www.netscape.com/download">Netscape</a>
		及
		<a href="http://www.microsoft.com/windows/ie/">Internet&nbsp;Explorer</a>任意组合使用。
<ul>
<!-- 		<li>
			<A HREF="http://www.nexternet.com/download" target="VRML"><IMG SRC = "images/pivoron_90x30.gif" align="MIDDLE" BORDER="1" width=90 height=30 title="Download Pivoron"></A>
			<A HREF="http://www.nexternet.com/download" target="VRML">Pivoron</A>
			by
			<a href="http://www.nexternet.com" target="VRML">Nexternet</a>
		</li> -->
		<li>
			<A HREF="http://www.parallelgraphics.com/cortona" target="VRML"><IMG SRC = "../../images/cortbest.gif" align="MIDDLE" BORDER="1" width=88 height=31 title="Download Cortona"></A>
			<A HREF="http://www.parallelgraphics.com/cortona" target="VRML">Cortona 3.1</A>
			by
			<A HREF="http://www.parallelgraphics.com/cortona" target="VRML">Parallel Graphics</a>
		</li>
		<li>
			<A HREF="http://www.cosmosoftware.com/download" target="VRML"><IMG SRC = "../../images/cplayer21.gif" align="MIDDLE" BORDER="1" width=88 height=31 title="Download CosmoPlayer"></A>
			<A HREF="http://www.cosmosoftware.com/download" target="VRML">CosmoPlayer 2.1.1</A>  (~3MB)
		</li>
		<li>
			<A HREF="http://www.karmanaut.com/cosmo/player" target="VRML"><IMG SRC = "../../images/cplayer21.gif" align="MIDDLE" BORDER="1" width=88 height=31 title="Download CosmoPlayer"></A>
			<A HREF="http://www.karmanaut.com/cosmo/player" target="VRML">Karmanaut mirror site:  CosmoPlayer 2.1.1</A>  (~3MB)
		</li>
		<li>	<a href="http://www.MediaMachines.com" target="_blank">MediaMachines Flux</a>  Internet Explorer X3D/VRML97插件;体验版，不是SIGGRAPH&nbsp;2004 Beta&nbsp;2版
		</li>
</ul>


  		
<table summary="">
<tr><td>
<a href="examples/HelloWorld.wrl" target="VRML"><IMG SRC = "../../images/HelloWorld.gif" align="MIDDLE" BORDER="0" width="80" height="80" title="Hello World"></a>
</td>
<td>
看看是否你的VRML浏览器安装成功，可以去查看<a href="examples/HelloWorld.wrl" target="VRML">HelloWorld.wrl</a>示例场景。
</td>
</tr>
</table>


</li>

<li>
    <a name="Java">安装<b>Java</b></a> 
		使用一个<a href="http://java.sun.com/j2se/1.4/download.html" target="_blank">在线发布的版本</a>。（需要Java环境来运行Xeena工具）在安装的时候，你需要接受非限制性Java许可。
<br/>
		如果Java已经安装了，你可以省了下载这个步骤。可以打开<code>命令</code>窗口，敲入<pre>
		c:\>  <b>java -version</b>
</pre>
来测试Java是否安装。
		
<!--
 		<ul>
				<li><b>Java JRE 1.3.1</b> (also called Java Run-Time Environment Version 1.3.1) or higher.
				  <ul>
						<li>~5MB</li>
						<li><a href="http://java.sun.com/j2se/1.3.1/jre" target="_blank">http://java.sun.com/j2se/1.3.1/jre</a></li>
						<li>Usually Java goes in <code><b>c:\Program Files\JavaSoft\JRE\1.3.1_09</b></code> (or similar directory)</li>
						<li>Only allows running Java classes, which is sufficient to run X3D-Edit/Xeena</li>
				  </ul>
				<p>
					<font color="green">OR</font>
				</p>
				</li>
				<li><b>Java JDK 1.3.1</b> (also called Java 2 SDK, Standard Edition Version 1.3.1) or higher.
				  <ul>
						<li>~30MB</li>
						<li><a href="http://java.sun.com/j2se/1.3.1" target="_blank">http://java.sun.com/j2se/1.3.1</a></li>
						<li>Usually Java goes in <code><b>c:\jdk1.3.1_09</b></code> (or similar directory)</li>
						<li>Also provides development environment for compilation, debugging etc.</li>
				  </ul>
				</li>
		</ul>
</li>
 -->
<li> <a name="Xeena"></a>（这里放弃了原作者内容，改成本站修正版说明）<br />(右键另存，下载后扩展名改为7z)<a href="http://www.web3d.org/download/X3D-Editv3.1.txt">X3D-Edit3.1修正版</a> 原作者设想将整个软件置于系统根目录，这种思路太不符我们的习惯，我做了一些修改，让其可以自由的放置，当然，放在中文目录下是大大的有问题的。<br>
    正常安装了JDK或JRE后，系统注册表中会加入相应信息，不需额外指定Java_home。但老版本或绿色版则必须手动指定Java环境的路径。所以大家在使用前就需要注意这样的问题。可以直接在命令文件中Set java_home，也可以在系统变量中追加java_home这一项。Java路径选JDK的安装路径，如“C:\Program Files\Java\jdk1.7.0”。<br>
    正常使用请直接点击X3D-Edit-Chinese.bat或X3D-Edit.bat，tools目录下一些格式转换工具，暂时没实际使用过，Vrml97ToX3dNist.bat这个命令可以用，但里面其他的配置文件基本上都是有问题的，熟悉者可自行修正。<br>
    另外，X3D-EDIT里面那几个XSL转换的样式文件路径还有些问题，暂时不能正常使用。<br>
    注：这个软件虽然比较简单，但对我们学习X3D确实有莫大的帮助。它可以帮我们了解整个X3D的应用体系，以及具体的使用方法，最重要的是可以保证无错。<br>
   相关链接：
    <a href="http://www.alphaWorks.ibm.com/tech/xeena" target="Xeena">http://www.alphaWorks.ibm.com/tech/xeena</a>  (~5MB).
<br/>
<br/>

</li>

<li>
略</li>
<li>
	<A href="http://www.geovrml.org/1.0/download/">安装 GeoVRML</A>.
</li>


<li>
	<A href="http://www.web3d.org/WorkingGroups/vrtp/dis-java-vrml/download.html">安装 DIS-Java-VRML</A>.
</li>

<h3><a name="Updates">下载更新包</a></h3>
</li>

<li>
    从<a href="http://www.web3d.org/x3d/content/X3D-Edit.zip">http://www.web3d.org/x3d/content/X3D-Edit.zip</a>下载X3D-Edit更新包(~30&nbsp;MB)。
<!-- 	or
    <br>
    <a href="http://www.web3d.org/x3d/content/X3D-Edit.tar.gz">http://www.web3d.org/x3d/content/X3D-Edit.tar.gz</a> -->
<br/>
<br/>
</li>

<li>
    <b>推荐安装</b>：  
		下载<a href="help.#examples">X3d实例包</a>

<br/>
<br/>
		<a href="http://www.web3d.org/x3d/content/examples">X3D实例</a>可以在线查看：
		<br />
		<a href="http://www.web3d.org/x3d/content/examples">http://www.web3d.org/x3d/content/examples</a> 及
		<br />
		<a href="http://www.web3d.org/x3d/content/examples/Vrml2.0Sourcebook">http://www.web3d.org/x3d/content/examples/Vrml2.0Sourcebook</a>.
<br/>
<br/>

</li>

<li>
    <b>推荐安装</b>：  
		下载<b>ConformanceNist实例包</b>&nbsp;(~150&nbsp;MB)，从
		<br>
    <a href="http://www.web3d.org/x3d/content/examples/ConformanceNistSuite.zip">http://www.web3d.org/x3d/content/examples/ConformanceNistSuite.zip</a>

<br/>
<br/>
		<a href="http://www.web3d.org/x3d/content/examples/ConformanceNist">ConformanceNist实例</a>
		也可在线查看:
		<a href="http://www.web3d.org/x3d/content/examples/ConformanceNist">http://www.web3d.org/x3d/content/examples/ConformanceNist</a>.

<br/>
</li>

<li>	<font color="GREEN"><b>全部完成！</b></font>  
<ul>
  <li>是时候运行X3D-Edit了</li>
	<li>查看
	<a href="#Usage">用法</a> 以了解更多的X3D-Edit指导</li>
	<li>查看
	<a href="#Bugfixes">Bug修复</a> 如果你在X3D-Edit使用中遇到了麻烦</li>
	<li>查看
	<a href="examples/help.html" target="_blank">X3D/VRML 帮助</a> 了解更多的X3D资源</li>
	<li>欢迎<a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20Auto-Installer%20feedback%20">反馈</a>!</li>


</ul>	
</li>
</ol>


<hr width="50%">

<h3><a name="Features">特性</a></h3>
<ul>
    <li>直观的、强大的<a href="../../images/X3D-EditSampleScreenSnapshot.png">用户界面</a></li>
    <li>总是创建良好组织性的场景图：节点只在被允许的地方配合出现（注：主要指界面左边的Profile提示工具箱）</li>
    <li>对X3D场景作VRML97 Profile与核心Profile有效性验证</li>
    <li>自动将X3D场景转换成VRML格式，并启动浏览器查看结果（注：很多浏览器都还只支持VRML或不完全支持X3D）</li>
    <li>大量的<a href="#examples">X3D场景范例</a></li>
    <li>对每个元素及属性都有相应的提示弹出，帮你学习VRML/X3D场景图怎样真正的工作。</li>
    <li>使用Java，保证了平台独立性</li>
    <li>可扩展XSLT：
		<a href="X3dToVrml97.xslt" target="_blank">X3dToVrml97.xslt</a> (对VRML&nbsp;97的向后兼容性),
		<a href="X3dToXhtml.xslt" target="_blank">X3dToXhtml.xslt</a> (标签匹配美化输出)，及<a href="X3dWrap.xsl" target="_blank">X3dWrap.xsl</a>&nbsp;/&nbsp;<a href="X3dUnwrap.xsl">X3dUnwrap.xsl</a>
		(供“容器型标签”的添加/移除使用 注：参考<a href="#Compact">紧凑形式</a>)</li>
    <li>对<a href="X3D-EditSampleScreenSnapshot-DIS-Java-VRML.png">DIS-Java-VRML</a>扩展节点的支持，其由<a href="http://www.web3d.org/WorkingGroups/vrtp/dis-java-vrml/dis-java-vrml.html" target="_blank">DIS-Java-VRML工作组</a>定义，
    		(<a href="http://www.web3d.org/WorkingGroups/vrtp/dis-java-vrml/dis-java-vrml.html" target="_blank">http://www.web3d.org/WorkingGroups/vrtp/dis-java-vrml</a>)，该工作正在设计与评估之中。
    <li>Support for editing georeferenced
				<A href="examples/GeoSpatial/newGeoSpatialScene.png">GeoVRML nodes</a>，其由<A href="http://www.geovrml.org/1.0/doc" target="_blank">GeoVRML&nbsp;1.0</a> profile 中定义。
				(<A href="http://www.geovrml.org/1.0/doc" target="_blank">http://www.geovrml.org/1.0/doc</a>)
		</li>
    <li>Support for draft
		支持<a href="http://www.h-anim.org/Specifications/H-Anim2001">H-Anim&nbsp;2001 仿人体动画规范</a>草案，并可以编辑替身（avatar）<a href="examples/HumanoidAnimation/NancyNativeTags.png">仿人体动画节点</a>。还支持<a href="http://ece.uwaterloo.ca:80/~h-anim/spec1.1" target="_blank">H-Anim&nbsp;1.1</a> profile 
				(<a href="http://ece.uwaterloo.ca:80/~h-anim/spec1.1" target="_blank">http://ece.uwaterloo.ca:80/~h-anim/spec1.1</a>)
		</li>
    <li>支持提议的新节点<a href="http://www.web3d.org/x3d/specification/part1/nodesDef.html#KeySensor" target="_blank">KeySensor</a>
    		与
    		<a href="http://www.web3d.org/x3d/specification/part2/nodesDef.html#StringSensor" target="_blank">StringSensor</a>。
    		但是请注意keyboad节点的原型支持还未实现。
    <li>支持提议的
    		<a href="http://www.blaxxun.com/support/developerguide/developer/contact/3d/nurbs/spec/nurbsproposal.html" target="_blank">Non-Uniform Rational B-Spline (NURBS) Surface</a>扩展节点, 由
    		<a href="http://www.blaxxun.com" target="_blank">blaxxun interactive</a>提议。当前还在开发与评估中。
			但是请注意对Nurbs节点原型的完全支持还未实现。
    <li>场景图打印，带标签或图标(部分打印机上支持，这项Xeena功能有点bug)</li>
</ul>

<hr width="50%">

<h3><a name="Details">细节</a></h3>

	 <p><b>X3D-Edit</b>采用简化（compact 注：超出译者知识范围，不知是否翻译准确）XML标签集，由X3D简化文档类型定义（DTD）</p>
	 <ul>
		<li>	<a href="x3d-compact.dtd">x3d-compact.dtd</a></li>
		<li>	<a href="x3d-3.0-InputOutputFields.dtd">x3d-3.0-InputOutputFields.dtd</a></li>
		<li>	<a href="x3d-3.0-Web3dExtensions.dtd">x3d-3.0-Web3dExtensions</a></li>
	 </ul>

<dl>
3.0版与
<dt><b>各历史版本</b></dt>

<dd>
		<font color="GREEN"><b>X3D-Edit v3.0</b></font>
		X3D国际规范草案。在<a href="x3d-dtd-changelog.txt" target="_blank">x3d-dtd-changelog.txt</a>文件中详细描述了修改情况。
</dd>

<dd>
		<font color="GREEN"><b>X3D-Edit v2.4</b></font>包含对X3D规范最终委员会草案进行最终测试的DTD，该DTD重编为3.0。v2.4也包含了一些重要的标签集变化：原型接口/原型正文、容器域（containerField）、不能设置仅输入/仅输出访问类型的域、加上更严格的X3dToVrml97.xslt转换验证检测。
</dd>

<dd>
		<font color="GREEN"><b>X3D-Edit v2.3</b></font>
		包含了Geometry2D, MultiTexture and Event Utility节点，以及IS/connect, 域/域值&nbsp;USE, 类型与访问类型重命名等标签集的重要变化。
</dd>
<dd>
		<font color="GREEN"><b>X3D-Edit v2.2</b></font>
		包含了VRML导入能力。
</dd>
<dd>
		<font color="GREEN"><b>X3D-Edit v2.1</b></font>
		包含
		<ul>

		<li>更多简化标签集：去除了<code>&lt;proxy&gt;</code>，同时用属性 <code>containerField</code> 表示默认的父-子关系名称。，<code>&lt;proxy&gt;</code>节点将被视为非法（用<code>USE="nameTargetDEF"</code>属性代替）</li>
		<li>保留了全局“class”属性，以便将来使用XML层叠样式表（CSS），同HTML样式表使用类似。</li>
		<li>导入/导出体验的支持，用于跟踪进/出内联节点（Inline）的值。</li>
		<li>不再允许<code>&lt;USE&gt;</code> 元素，由于缺乏对节点与属性值的类型检测，而且目前是一项多余功能。新标准中采用@USE属性代替，如&lt;Shape USE="MyShapeNode"/></li>
		
		</ul>
		同时，使用<a href="http://www.alphaWorks.ibm.com/tech/xeena" target="Xeena">Xeena&nbsp;的1.2&nbsp;EA</a> 版本.
</dd>
<dd>
		<b>X3D-Edit v2.0</b>
		包含了节点类型（nodeType）与访问类型（accessType）属性的变更及<font color="GREEN">属性值的有效性验证</font>。
</dd>
<dd>
		<b>X3D-Edit v1.8</b>
		包含头部标签集的变更。
</dd>
<dd>
		<b>X3D-Edit v1.7</b>
		包含DIS-Java-VRML, GeoVRML 与 H-Anim 节点支持。
		<br>
		&nbsp;&nbsp;&nbsp;现在使用
		<a href="x3d-compact.dtd">x3d-compact.dtd</a>
		标签集 (无包裹标签)。
</dd>
<dd>    <b>v1.6</b> 对应于 x3d-compromise.dtd (October 2000) + 完整的资源手册实例、 KeySensor + StringSensor + NURBS。
		<br>
		&nbsp;&nbsp;&nbsp;这个版本及对应的实例都使用
		<a href="x3d-compromise.dtd">x3d-compromise.dtd</a>，带包裹（wrapper）标签。可下载：
		<a href="X3D-Edit-1.6.zip">X3D-Edit-1.6.zip</a>
		与
		<a href="X3D-Examples-1.6.zip">X3D-Examples-1.6.zip</a>。</dd>
<dd>    <b>v1.5</b> 对应x3d-compromise.dtd (September 2000) + GeoSpatial + H-Anim + DIS-Java-VRML + 扩展</dd>
<dd>    <b>v1.4</b> 对应x3d-compromise.dtd (July      2000) + 扩展</dd>
<dd>    <b>v1.3</b> 对应x3d-compromise.dtd (May       2000)</dd>
<dd>    <b>v1.2</b> 对应x3d-compromise.dtd (April     2000)</dd>
<dd>    <b>v1.1</b> 对应x3d-draft.dtd      (February  2000)</dd>
<dd>	<b>原始版本</b>:  1 November 1999</dd>

<dt><b>软件作者</b></dt>
<dd>
		<a href="http://web.nps.navy.mil/~brutzman/">Don Brutzman</a>
		<a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20feedback%20">brutzman&nbsp;at&nbsp;nps.navy.mil</a>
</dd>

<dt><b>发布包</b></dt>
<dd><a href="http://www.web3d.org/x3d/content/X3D-Edit.zip">http://www.web3d.org/x3d/content/X3D-Edit.zip</a></dd>

<dt><b><a name="examples">实例内容</a></b></dt>
<dd>X3D-Edit是一款完全的测试性工具。X3D-Edit被用来创作一套多元化的X3D/VRML场景，如下：
</dd>
<dd><a href="http://www.web3d.org/x3d/content/examples/help.html" target="_blank">实例帮助</a></dd>
<dd><a href="http://www.web3d.org/x3d/content/examples" target="_blank">http://www.web3d.org/x3d/content/examples</a></dd>
<dd><a href="http://www.web3d.org/x3d/content/examples/Vrml2.0Sourcebook">http://www.web3d.org/x3d/content/examples/Vrml2.0Sourcebook</a></dd>
<dd><a href="http://www.web3d.org/x3d/content/examples/ConformanceNist">http://www.web3d.org/x3d/content/examples/ConformanceNist</a></dd>
<dd><a href="http://web.nps.navy.mil/~brutzman/Savage">http://savage.nps.edu/Savage</a></dd>

<dt><b>屏幕截图</b></dt>
<dd><a href="../../images/X3D-EditSampleScreenSnapshot.png">X3D-EditSampleScreenSnapshot.png</a>用户界面</dd>
<dd><a href="../../images/newGeoSpatialScene.png">examples/GeoSpatial/newGeoSpatialScene.png</a> GeoVRML节点</dd>
<dd><a href="../../images/NancyNativeTags.png">examples/HumanoidAnimation/NancyNativeTags.png</a> H-Anim节点</dd>

<dt><b>Icon概要图</b></dt>
<dd><a href="icons/IconSheet-1.pdf">IconSheet-1.pdf</a>,
    <a href="icons/IconSheet-2.pdf">IconSheet-2.pdf</a>,
    <a href="icons/IconSheet-3.pdf">IconSheet-3.pdf</a>,
    <a href="icons/IconSheet-4.pdf">IconSheet-4.pdf</a></dd>

<dt><b>许可</b></dt>
<dd>X3D-Edit中的文件是X3D任务组的开源公共领域的产品。</dd>
<dd>在下载或安装那些工具每一部分的时候，提供非严格性Sun
    <a href="http://java.sun.com/j2se/1.3/j2sdk1_3_0.license" target="_blank">Java许可</a>及对<a href="http://www.alphaWorks.ibm.com/tech/xeena" target="Xeena">Xeena</a>非严格性IBM许可。</dd>
<dd><a href="http://www.ibm.com">IBM</a> 已经慷慨的允许<a href="http://www.web3d.org">Web3D组织</a>在WEB3D/X3D<a href="http://sdk.web3d.org" target="_blank">软件开发工具包(SDK)</a>中包含Xeena。
    </dd>

</dl>
    
<hr width="50%">

<h3><a name="Usage">用法</a></h3>

<ol>

<li>

<a href="X3D-Edit.bat"><img src="images/x3d2-s.gif" width="77" height="49" align="middle" border="0" title=""></a> 
		
		<a href="X3D-Edit.bat">X3D-Edit</a>启动快捷方式

</li>


<li>

<b>Windows shell调用</b>：

</li>

<li>

<b>Unix shell调用</b>：
<!--     <b>source xeena.sh</b> -->

</li>

<li>

    <b>Xeena细节</b>.
		好东西仍然值得去挖掘：
		<a href="file:///C|/IBM/Xeena/README.html" target="Xeena">安装 README</a>的本地拷贝帮您查找安装故障。
		通过阅读
		<a href="file:///C|/IBM/Xeena/help/index.html" target="Xeena">帮助 (用户指导)</a>，你可以了解所有与用户界面相关的内容。
		其它的任何东西也许在
		<a href="file:///C|/IBM/Xeena/FAQ.html" target="Xeena">常见问题集(FAQ)</a>页面中可以找到答案。
</li>

</ol>

<hr width="50%">

<h3><a name="Compact">简化形式</a></h3>

<p><i>这部分内容不再属于目前X3D版本。你可以放心的忽略它，简化形式与折衷形式内容的文档仅仅作为存档目的。</i></p>

<p>你可以轻易的对“老化”了的内容进行简化，即通过使用<code><b>X3dUnwrap</b></code>，移除"wrapper&nbsp;标签" (<code>&lt;children&gt; &lt;appearance&gt; &lt;geometry&gt;</code> 等)。这也会让你从早期版本升级到<b>X3D-Edit v&nbsp;1.7</b>。
</p>

<p>
从顶部菜单中选择“<b>Tools</b>”-“<b>Process XSL</b>”。用显示的<code>X3dUnwrap.xsl</code>样式表来展开你的场景。备份你的原始文件（或以不同文件名保存）是个好主意。<b>Process XSL</b>窗口可以左右伸缩，这样更易查看。
</p>

<img src="../../images/X3D-Edit.LaunchX3dUnwrap.xsl.png" title="X3D-Edit launch X3dUnwrap.xsl stylesheet" width="531" border="0">

<p>
样式表还会标签集文档类型定义（DTD）从<a href="x3d-compromise.dtd"><code>x3d-compromise.dtd</code></a>更新到<a href="x3d-compact.dtd"><code>x3d-compact.dtd</code></a>。
</p>

<p>
示例截图，显示
<a href="../../images/CoordinateAxesSceneGraph-CompromiseWrapped.png" target="_blank">"之前" (折衷的包裹标签，X3D-Edit v1.6)</a>
及
<a href="../../images/CoordinateAxesSceneGraph-CompactUnwrapped.png" target="_blank">"之后" (简化的展开形式，X3D-Edit v1.7)</a>
的场景图。
</p>

<hr width="50%">

<h3><a name="Developers">开发者</a></h3>

<p>
接下来是与这个项目有关的一些微小细节。
这个主要是文档目的，常规使用是不需要的。
</p>

<h4>开发者的可选用法</h4>
    
<p>
Besides X3D-Edit.bat, example Xeena editor invocations under Windows follow.
Edit to match your your locally installed subdirectories as needed.
</p>

<>
C:\ibm\Xeena> xeena.bat  -dtd c:\www.web3d.org\x3d\content\x3d-compromise.dtd  -root X3D


C:\ibm\Xeena> xeena.bat  -dtd c:\www.web3d.org\x3d\content\x3d-compromise.dtd  -root X3D  -xml c:\www.web3d.org\x3d\content\examples\AllVrml97Nodes.xml
</p>
<p>
There are many example invocations and shortcuts in the 
<a href="Makefile">Makefile</a>.
</p>


<h4>更换安装目录</h4>
<p>
    <u>Not recommended</u> (which means "<u>skip this section</u>").
		If you insist on changing the installation directory (!) 
    then you will need to edit the second line (DOCTYPE) of
    <a href="x3d-compromise.dtd">x3d-compromise.dtd</a>,
    and you will also need to edit the following files:
    <a href="x3d-compromise.profile.X3D-Edit1.6">x3d-compromise.profile.X3D-Edit-1.6</a>,
    <a href="x3d-compromise.profile">x3d-compromise.profile</a>,
    <a href="X3D-Edit-1.6.bat">X3D-Edit-1.6.bat</a>,
    <a href="X3D-Edit.bat">X3D-Edit.bat</a> and
    <a href="Makefile">Makefile</a> (if used)
    to match your local directory structure.  
	You will likely have to edit the examples as well, though if you are connected to the network,
	Xeena will try to find the website version of the DTD.
</p>


<h4>XSL样式表及转换工具</h4>

<ul>

<li>
<p>
    X3D to VRML 97 translation is via XSLT script 
    <a href="X3dToVrml97.xslt">X3dToVrml97.xslt</a>
		and batch file
    <a href="X3dToVrml97.bat">X3dToVrml97.bat</a>
</p>
</li>

<li>
<p>
    There are several compliant Extensible Stylesheet Language (XSL)
    processors available because the 
		<a href="http://www.w3.org/TR/xslt" target="_blank">W3C XSL&nbsp;Recommendation</a>
    (<a href="http://www.w3.org/TR/xslt" target="_blank">http://www.w3.org/TR/xslt</a>)
		is stable (November&nbsp;1999).
</p>	
</li>		

<li>
<p>
    One excellent XSL transformation engine is 
		<a href="http://saxon.sourceforge.net" target="_blank">SAXON</a>
		at
    <a href="http://saxon.sourceforge.net">http://saxon.sourceforge.net</a> - this includes
    "<i>Instant Saxon</i>," 
		a 250KB Windows command-line executable.
</p>
</li>

<li>
<p>
    <a href="X3dToVrml97.bat">X3dToVrml97.bat</a> shows how to invoke saxon and the following tools.
</p>		
</li>

<li>
<p>
    X3D to HTML translation is also provided (for pretty printing) via
    <a href="X3dToXhtml.xslt">X3dToXhtml.xslt</a>
		and
    <a href="X3dToXhtml.bat">X3dToXhtml.bat</a>
</p>
</li>
 
<li>
<p>
    Trapezium's vorlon tool for VRML syntax checking is available at
    <a href="http://www.trapezium.com" target="_blank">http://www.trapezium.com</a>
</p>
</li>

<li>
<p>
    <a href="mailto:Robert.Crispen@HSV.Boeing.com()?subject=vpp%20for%20X3D-Edit%20comment%20">Bob Crispen</a>'s 
  	<i>vpp</i> tool at
		<a href="http://hiwaay.net/~crispen/vrml" target="_blank">http://hiwaay.net/~crispen/vrml</a>
  	for VRML pretty printing.  An edited copy of <i>vpp</i> is included in this
  	distribution with bigger MAXBUFSIZE for our big test-file comments.  Thanks Bob!
</p>
</li>

</ul>

<h3><a name="Bugfixes">Bug修复</a></h3>


<p>
<font color="color">Many bugs are avoided altogether</font> (especially Windows ME and 98) by using the
<a href="http://www.web3d.org/x3d/content/X3D-EditAutoInstall/Web_Installers/install.htm">X3D-Edit Auto Installer</a>
for various operating systems (Windows, Mac, Linux, Unix/Solaris). 
</p>
<p>
<a name="bug0"><b>0.  X3D-Edit can't open example scenes due to being disconnected from the network.</b>

The underlying Xeena tool can't be modified to substitute local DTDs for online DTDs, causing a validation error when opening most scenes when offline.
The best correction to this problem is simply to connect to the network.
<ul>
		<li><i>Windows workaround #1</i>:  open X3D scenes one at a time by invoking X3D-Edit via the command line.  Example:
		<pre>C:\www.web3d.org\x3d\content>x3d-edit examples\HelloWorld.x3d</pre>
		
		<p><a href="X3D-Edit.exampleConsoleOutput.txt">Example console output</a> shows normal X3D-Edit operation.
      A normal program exit allows the executing batch file to convert the DOCTYPE back to final form.
		</p>
		</li>
		<li><i>Windows workaround #2</i>:  open X3D scenes one at a time by clicking on them from Windows Explorer.
				Configure Windows Explorer to recognize .x3d files via the Tools menu, selecting Folder Options and entering the .x3d file type as follows.
				<p>
				<img src="images/WindowsExplorerToolsFolderOptionsX3D.png" alt="Windows Explorer -> Tools -> Folder Options -> X3D"/>
				<img src="images/WindowsExplorerToolsFolderOptionsX3D.EditFileType.png" alt="Edit File Type"/>
				</p>
		</li>
		<li><i>Java-based workaround #3</i>:  use the <a href="examples/X3dSceneAuthoringHints.html#X3dDtdChecker"><code>X3dDtdChecker</code></a> tool
				to convert DTD references.
		</li>
		<li><i>Manual workaround #4</i>:  refer to the <a href="examples/X3dSceneAuthoringHints.html#DOCTYPE">X3D Scene Authoring Hints</a> 
				and use a text editor to manually change the DOCTYPE.
		</li>
</ul>
 
</p>


<p>
<a name="bug1"><b>1.  Xeena/X3D-Edit works under JDK&nbsp;1.4</b></a>, except for the "Allowed&nbsp;Nodes" pane.
Workarounds:  use the other panes,
install the 
<a href="http://www.web3d.org/x3d/content/X3D-EditAutoInstall/Web_Installers/install.htm" target="_blank">X3D-Edit Auto Installer</a> version, 
or supplement JDK&nbsp;1.4 with
<a href="#Java">JDK&nbsp;1.3.1_09</a> 
instead.
</p>

<p>
<a name="bug2"><b>2.  A common installation problem follows.</b></a>
This can occur under Windows&nbsp;95, Windows&nbsp;98 or Windows&nbsp;Millenium&nbsp;(ME).
The fix is the same either way.
</p>
<pre>
] If you're running Windows 95/98/ME, and encounter an "Out of environment space" 
] error, then you'll need to increase the size of the environment table.  
] You can do this at the command line (which is temporary) or by editing 
] a configuration file to make a permanent change (which requires restarting 
] your computer). 
] 
]      To temporarily increase environment space for X3D-Edit.bat, 
]      first enter the following command at the DOS prompt: 
] 
]         <code>C:\www.web3d.org\x3d\content&gt;   <b>command /e:8192 </b></code>
] 
]         <code>C:\www.web3d.org\x3d\content&gt;   <b>X3D-Edit </b></code>
] 
]      <font color="GREEN"><b>To permanently increase environment space</b></font>, 
]      add the following line to your <code>C:\CONFIG.SYS</code> file,
]      save all files, and then restart (reboot) your system: 
] 
]          <b>shell=command.com /e:8192 /p </b>
] 
]      Once you've increased the size of the environment table,
]      try running Xeena again.  If there is still a problem,
]      please cut/paste the command-window text into an email and
]      <a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman),clblais@nps.navy.mil(Curt%20Blais)?subject=X3D-Edit%%20">report the problem</a>.

</pre>

<p>Alternative for Windows&nbsp;Millenium&nbsp;(ME) from Tom Greenwald, NPS.
</p>

<pre>
] For both Xeena and X3D-Edit I had to right click on the icon, left click
] on properties, click the memory tab, set the initial environment to
] 4096, set extended (XMS) memory to 8192, and set MS-DOS protected mode
] (DPMI) memory to 8192.
</pre>


<p>You may need to reboot your computer for these changes to take effect.
You will also have to repeat this step whenever you update X3D-Edit, so you
may prefer the permanent change above.</p>

<p>
<a name="bug3"><b>3.  If you use the older version&nbsp;1.1 of Xeena (instead of 1.2EA), the following errors appear:</b></a>
</p>
<pre>
<font color="RED">
	C:\www.web3d.org\x3d\content>c:\ibm\Xeena\xeena.bat 
	  -dtd "c:\www.web3d.org\x3d\content\x3d-compromise.dtd"
	  -root X3D 
	  -xml "c:\www.web3d.org\x3d\content\examples\newScene.xml"
	
	Syntax error
	Syntax error
	running Xeena with Java 2
	Exception in thread "main" java.lang.NoClassDefFoundError:
	com/ibm/hrl/xmleditor/Xeena
</font>
</pre>

<p>
To fix this problem:  uninstall Xeeena&nbsp;1.1,
install
<a href="http://www.alphaWorks.ibm.com/tech/xeena" target="Xeena">Xeena&nbsp;1.2&nbsp;EA</a>,
and again extract 
<a href="X3D-Edit.zip">X3D-Edit.zip</a>
(to correct the Xeena CLASSPATH bug).
Or simply uninstall X3D-Edit and use the
<a href="#autoinstaller">autoinstaller</a>
instead.
</p>

<p>
<a name="bug4"><b>4.  After importing a VRML97 scene, the XSL buttons do not work.</b></a>
</p>

<p>
 The following obscure message may appear in the console:
</p>
<pre>
 java.lang.StringIndexOutOfBoundsException: String index out of range: -1
</pre>
<p>
Fix:  save the imported scene as a file.  
This may require renaming your scene if it was originally a read-only file (such as <code>newScene.x3d</code>).
The XSL buttons now work.
See above for more instructions on using the 
<a href="#VRML97Import">VRML97 Import capability</a>.
</p>

<p>
<a name="bug5"><b>5.  Insufficient memory.</b></a>
</p>

<p>
   You will need 128MB of RAM or more.  Yes, 128.
</p>

<p>
    <a name="bug6"><b><a name="OfflineDTDproblem">6.  The window goes blank and locks up before displaying a scene.</a></b></a>
</p>

<p>
    This is likely a 
		<a href="examples/X3dSceneAuthoringHints.html#Authoring">DOCTYPE/DTD problem</a>:  
		Xeena is attempting to retrieve the DOCTYPE/DTD via the network,
		without success.  
		When using Java&nbsp;1.3 or earlier, this problem can only be fixed by 
		replacing the DOCTYPE/DTD or else by connecting to the network, thus gaining access to the final DTD url.
</p>
<p>
		Fixes and workarounds:  
		<ul>
				<li>upgrade to 
				    Java&nbsp;1.4, 1.5
						or later
				    so that 
						<a href="X3dDtdChecker.java">X3dDtdChecker.java</a>
						can fix this problem at launch time (drag/drop or clicking on file icon)</li> 
				<li>connect to the network for X3D scenes using the final X3D DOCTYPE/DTD</li> 
				<li>manually edit the scene first (in another XML/text editor) to use the X3D Transitional DTD.
						See the
						<a href="examples/X3dSceneAuthoringHints.html#Authoring">X3D Scene Authoring Hints</a>
			 			for further details on DOCTYPE.</li> 
	 </ul>
</p>

<p>
<a name="bug7"><b>7.  You want to use an http proxy server.</b></a>
</p>


<p>	The http proxy server feature is for loading a file via the Web.  Not a very common setting, but nice to have nevertheless.
</p>
<p>	You will need to uncomment and update the line in X3D-Edit's modified 
<a href="C:\IBM\Xeena\Xeena.bat">C:\IBM\Xeena\Xeena.bat</a>
for 
<code>set PROXY_SETTINGS</code>.  Warning:  we've had trouble with this feature under Windows&nbsp;98.
</p>


<p>
<a name="bug8"><b>8.  Some developers might not have <i>Make</i> installed...</b></a>
</p>


<p>	<i>Make</i> is not necessary to run X3D-Edit, it is only used for X3D-Edit source development.
The Makefile is being replaced by an Ant build file.
</p>

<p>
    <i>Make</i> is available
    via the Cygnus distribution of GNU Utilities for PCs at 
    <a href="http://sourceware.cygnus.com/cygwin">http://sourceware.cygnus.com/cygwin</a>.
    The Cygwin distribution provides Unix command line and utilities on Windows 95/98/NT/2000. 
    Don't forget to upgrade your PATH with something like 
    <code>C:\cygnus\cygwin-b20\H-i586-cygwin32\bin;</code>.

    Once <i>Make</i> is installed, edit the Makefile filename/directory
    definitions to match your local installation.

    There are a bunch of alternate example invocations in the Makefile
    if you know how to grok <i>Make</i>.
</p>

	
<p>
    <a name="bug9"><b>9.  X3D-Edit can't seem to find the correct version of Java.</b></a>
</p>

<p>
		<a href="http://confluence.atlassian.com/display/DOC/Set+JAVA_HOME+variable+in+Windows">Set the JAVA_HOME environment variable</a>
		to the installation directory for Java on your system and X3D-Edit will use Java accordingly.
</p>
	
<p>
    <a name="bug10"><b>10.  No X3D scene appears in the browser.</b></a>
</p>

<p>
		<a href="help.html#Applications">Install a VRML or X3D plugin</a>
		in your Web browser.
</p>

	
<p>
    <a name="bug11"><b>11.  Internet Explorer (IE) blocks viewing the 3D scene.</b></a>
</p>

<p>
		The following screen snapshots illustrate this problem and 2 solutions.
</p>

<p>When the plugin is blocked from showing content, the following warning bar appears near the top of the browser.
Right click and select "<code>Allow blocked content...</code>" then select "Yes" to confirm.
</p>
<img src="images/WindowsXpAllowBlockedContentToRunForOneSession.png" alt="Windows Xp Allow Blocked Content To Run For One Session" border="0" width="1208" height="930" />

<p>Correct integration of the plugin then appears:
</p>
<img src="images/WindowsXpAllowBlockedContentToRunResult.png" alt="Windows Xp Allow Blocked Content To Run Result" border="0" width="1003" height="605" />


<p>You can permanently reset this permission by selecting <i>Internet&nbsp;Explorer -&gt; Tools -&gt; Internet Options... -&gt; Advanced</i>
and then under <i>Security</i> select "<code>Allow active content to run in files on My Computer</code>" as follows:
</p>
<img src="images/WindowsXpAllowBlockedContentToRunInternetOptions.png" alt="Windows Xp Allow Blocked Content To Run Internet Options" border="0" width="671" height="700" />
<p>Similar selections can be made for automatically running content from a CD, over the Internet, etc.
</p>

<p>
    <a name="bug12"><b>12.  How do I quickly update X3D-Edit and examples?</b></a>
</p>

<p>
		Menu shortcuts are provided under windows to easily retrieve updates.
		Always extract all .zip files to the <code>C:\</code> root directory.
</p>

<p>
<img src="images/WindowsStartProgramMenusX3dUpdates.png" alt="Windows Start Program Menus X3d Updates" border="0" width="1232" height="422" />
</p>

<p>
    <a name="bug12"><b>13.  IBM Haifa was very attentive in responding to bug reports
    regarding Xeena, the interface tool.</b></a>
    Unfortunately, despite the popularity of Xeena, their team is no longer working on this tool.
    We hope to fix known Xeena bugs someday.
    Nevertheless it still usually works fine for X3D-Edit.
<!--     X3D/Xeena bug reports/resolution
    are recorded in test-diagnostic scenes
    <a href="examples/AllVrml97Nodes.wrl">examples/AllVrml97Nodes.wrl</a>
		and
    <a href="examples/AllVrml97Nodes.x3d">examples/AllVrml97Nodes.x3d</a> -->
</p>

<hr width="50%">

<p>
Revised:  <a href="build.date.X3D-Edit.txt"><b>7 March 2007</b></a>			<!-- also see line 86 -->
</p>

<p>
Maintained by
<a href="http://web.nps.navy.mil/~brutzman">Don&nbsp;Brutzman</a>
<a href="mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit%20feedback%20">(<i>brutzman&nbsp;at&nbsp;nps.navy.mil</i>)</a>
</p>

<p>
		This page is available online at
    <a href="http://www.web3d.org/x3d/content/README.X3D-Edit.html">http://www.web3d.org/x3d/content/README.X3D-Edit.html</a>
</p>
</div>

<DIV id="footer">
Copyright &copy; 2004-2008 Jimmy.Chaw All Rights Reserved.<br>Email:<a href="mailto:web3d@live.cn">web3d@live.cn</a>

</DIV>

</DIV>

</body>      
</html>